home *** CD-ROM | disk | FTP | other *** search
/ Chip: 2005 Utilities / CHIP Utilities 2005.7z / CHIP Utilities 2005.iso / Bazy / Archiwum / mdac_typxpl.exe / 1033 / RCDATA / CABINET / Sqlsrdme.txt < prev    next >
Text File  |  1999-05-27  |  15KB  |  333 lines
  1. ****************************************************************
  2.                       MICROSOFT SQL SERVER
  3.        STEROWNIK ODBC DLA PROGRAMU MICROSOFT SQL SERVER
  4.                PLIK README INSTALATORA, WERSJA 3.7
  5. ****************************************************************
  6.  
  7. W pliku opisano u┐ycie sterownika ODBC Microsoft SQL Server
  8. w wersji 3.7 z programem Microsoft SQL Server w wersji 6.5 lub 
  9. wcze£niejszej.
  10.  
  11. Poniewa┐ sterownik ODBC dla programu Microsoft SQL Server 
  12. w wersji 3.7 jest dostarczany z programem SQL Server 7.0.
  13. U┐ytkownicy programu SQL Server 7.0 powinni odwo│aµ siΩ do
  14. dokumentacji programu SQL Server 7.0 a nie do tego pliku Readme.
  15.  
  16. Zosta│y om≤wione nastΩpuj╣ce tematy:
  17.  
  18. 1. Przegl╣d
  19. 2. Instalowanie pliku Instcat.sql na serwerze 
  20. 3. Uzyskiwanie bibliotek sieciowych klienta 
  21. 4. År≤d│a dokumentacji dotycz╣ce u┐ywania sterownika ODBC 
  22.    z serwerem SQL Server 
  23. 5. U┐ywanie sterownika w £rodowisku programistycznym 
  24. 6. Zagadnienia zgodno£ci
  25.  
  26. ****************************************************************
  27. 1. Przegl╣d
  28.  
  29. Sterownik ODBC dla programu Microsoft SQL Server w wersji 3.7, 
  30. jest sterownikiem Win32ODBC wersji 3.51. Mo┐e byµ wykorzystywany
  31. w aplikacjach napisanych zar≤wno dla interfejs≤w API ODBC 2.X, 
  32. jak i ODBC 3.X. Sterownik pracuje z programem Microsoft SQL 
  33. Server w wersji 4.21a lub nowszej. Sterownik dzia│a w systemach 
  34. Windows 98, Windows 95 lub Windows NT (w wersji 4.0 lub nowszej).
  35.  
  36. Wraz z wersj╣ 3.7 sterownika ODBC SQL Server jest tak┐e 
  37. instalowane narzΩdzie Win32 SQL Server 7.0 Client Network.
  38. NarzΩdzie to mo┐e byµ wykorzystywane z programem Microsoft SQL 
  39. Server w wersji 4.21a lub nowszej i bibliotekami sieciowymi 
  40. klienta dostarczanymi z t╣ wersj╣ programu SQL Server.
  41.  
  42. ****************************************************************
  43. 2. Instalowanie pliku Instcat.sql na serwerze 
  44.  
  45. Sterownik ODBC SQL Server u┐ywa zestawu procedur przechowywanych, 
  46. znanych jako procedury przechowywane katalog≤w, aby uzyskaµ 
  47. informacje z katalogu systemowego serwera SQL. Ka┐da 
  48. wersja sterownika ODBC SQL Server jest zaprojektowana do pracy 
  49. z okre£lon╣ wersj╣ procedur przechowywanych katalog≤w. 
  50. Plik Instcat.sql, znajduj╣cy siΩ w wersji 3.7 sterownika ODBC 
  51. programu SQL Server, zawiera aktualizacje pomocnicze dla procedur 
  52. przechowywanych katalog≤w aktualizuj╣ce procedury do wersji 
  53. u┐ywanej przez ten sterownik. Plik Instcat.sql dostarczony ze
  54. sterownikiem ODBC dla programu SQL Server w wersji 3.7 jest taki
  55. sam jak plik Instcat.sql dostarczany wraz z programem
  56. SQL Server 7.0. Witryny programu SQL Server 7.0 nie wymagaj╣ 
  57. uruchamiania pliku Instcat.sql.
  58.  
  59. Administrator systemu SQL Server musi u┐yµ skryptu Instcat.sql 
  60. do uaktualnienia procedur przechowywanych katalog≤w, aby zapewniµ 
  61. poprawne dzia│anie sterownika. Uaktualnienie procedur 
  62. przechowywanych katalog≤w nie ma wp│ywu na dzia│anie starszych 
  63. klient≤w serwera SQL. Musi to byµ wykonane dla wszystkich wersji
  64. programu Microsoft SQL Server, od 4.21a do 6.5. Uaktualnienie nie
  65. jest potrzebne, je£li wykorzystywany jest program SQL Server 7.0.
  66.  
  67. Aby uaktualniµ procedury przechowywane katalog≤w w programach 
  68. SQL Server 4.21a, 6.0 lub 6.5, administrator systemu uruchamia 
  69. skrypt u┐ywaj╣c narzΩdzia isql (zobacz instrukcje poni┐ej).
  70. Przed dokonaniem jakichkolwiek zmian w g│≤wnej bazie danych, 
  71. administrator systemu powinien wykonaµ jej kopiΩ. 
  72. Aby uruchomiµ narzΩdzie isql, komputer musi pracowaµ jako stacja
  73. robocza klienta dla serwera SQL Server.
  74.  
  75. W wierszu polecenia u┐yj narzΩdzia isql, aby uruchomiµ skrypt 
  76. Instcat.sql. Na przyk│ad:
  77.  
  78. C:>ISQL /Uas /has│o_as /Snazwa_serwera /ilokalizacja\Instcat.Sql
  79.  
  80. gdzie
  81. has│o_as 
  82.     Jest has│em administratora systemu.
  83. nazwa_serwera 
  84.     Jest nazw╣ komputera serwera, na kt≤rym dzia│a program 
  85.       serwer SQL Server.
  86. lokalizacja 
  87.     Jest pe│n╣ £cie┐k╣ dostΩpu do lokalizacj╣ pliku 
  88.       Instcat.Sql.
  89.  
  90. Skrypt Instcat.sql generuje wiele komunikat≤w. WiΩkszo£µ z nich 
  91. wskazuje, ile wierszy zosta│o zmodyfikowanych przez instrukcje 
  92. transakcyjne SQL wydawane przez skrypt. WiΩkszo£µ z tych 
  93. komunikat≤w mo┐na zignorowaµ, jednak trzeba sprawdziµ, czy nie ma 
  94. w£r≤d nich komunikat≤w  wskazuj╣cych b│Ωdy wykonania. Gdy skrypt 
  95. Instcat.sql jest uruchamiany przy u┐yciu programu SQL w wersji
  96. 6.0 Server, komunikat, ┐e obiekt sp_MS_upd_sysobj_category 
  97. nie istnieje, mo┐e byµ zignorowany. Ostatni komunikat powinien 
  98. wskazywaµ na pomy£lne zako±czenie dzia│ania skryptu Instcat.sql. 
  99. Wykonanie skryptu Instcat.sql nie powiedzie siΩ, je£li nie bΩdzie 
  100. wystarczaj╣co du┐o miejsca w g│≤wnej bazie danych, aby 
  101. zmagazynowaµ procedury przechowywane katalog≤w lub zarejestrowaµ 
  102. zmiany w istniej╣cych procedurach.
  103.  
  104. ****************************************************************
  105. 3. Uzyskiwanie bibliotek sieciowych klienta 
  106.  
  107. Sterownik ODBC dla programu SQL Server korzysta z bibliotek 
  108. sieciowych klienta SQL Server do komunikowania siΩ z serwerem.
  109. Sterownik ODBC SQL Server w wersji 3.7 u┐ywa tak┐e narzΩdzia 
  110. konfiguracyjnego SQL Server Client Configuration do zarz╣dzania 
  111. bibliotekami sieciowymi zwi╣zanymi ze ƒr≤d│em danych ODBC.
  112.  
  113. Sterownik ODBC SQL Server w wersji 3.7 instaluje tylko jedn╣ 
  114. bibliotekΩ sieciow╣, bibliotekΩ sieciowa nazwanego potoku Win32 
  115. Dbnmpntw.dll.
  116.  
  117. Mo┐na u┐ywaµ sterownika ODBC SQL Server w wersji 3.7 
  118. ze starszymi wersjami bibliotek sieciowych Win32. Je£li 
  119. potrzebna jest inna biblioteka sieciowa ni┐ nazwany potok, do 
  120. po│╣czenia siΩ z serwerem SQL Server mo┐na u┐yµ bibliotek 
  121. sieciowych, kt≤re by│y do│╣czone do u┐ywanej wersji programu 
  122. SQL Server. Biblioteki sieciowe programu SQL Server mo┐na
  123. uzyskaµ przez instalacjΩ narzΩdzi klienta Win32 SQL Server 
  124. Client dla tej wersji programu SQL Server.
  125.  
  126. Wersja narzΩdzia konfiguracyjnego SQL Server Client 
  127. Network instalowana ze sterownikiem ODBC SQL Server 
  128. wersji 3.7 mo┐e byµ u┐ywana z bibliotekami sieciowymi klienta 
  129. z wersji 4.12a lub nowszej programu SQL Server.
  130.  
  131. ****************************************************************
  132. 4. År≤d│a dokumentacji dotycz╣ce u┐ywania sterownika ODBC 
  133.    z serwerem SQL Server
  134.  
  135. Sterownik ODBC Microsoft SQL Server w wersji 3.7 jest tym
  136. samym sterownikiem kt≤ry dostarczany jest wraz z programem
  137. SQL Server 7.0. U┐ytkownicy programu SQL Server 7.0 mog╣ 
  138. odwo│aµ siΩ do dokumentacji programu SQL Server 7.0 dla
  139. sterownika ODBC programu SQL Serwer w wersji 3.7.
  140.  
  141. Gdy sterownik ODBC Microsoft SQL Server w wersji 3.7 u┐ywany
  142. jest z programem SQL Server (wersja 4.21a, 6.0 lub 6.5),
  143. sterownik pracuje w taki sam spos≤b jak starsze sterowniki.
  144. Mo┐na u┐yµ informacji specyficznych dla tych wersji programu 
  145. SQL Server zawartych w:
  146.  
  147. * Pliku pomocy drvssrvr.hlp dostarczonym z poprzednia wersja 
  148. programu SQL Server.
  149.  
  150. * Rozdziale "Programming ODBC for Microsoft SQL Server" 
  151. podrΩcznika programu SQL Server 6.5.
  152.  
  153. * Dokumencie "Programming ODBC for Microsoft SQL Server" 
  154. dostΩpnym w pakiecie MSDN. 
  155.  
  156.  
  157. Sterownik ODBC dla programu Microsoft SQL Server w wersji 3.7 
  158. jest tak┐e zgodny z kluczowymi dla sterownika informacjami 
  159. zawartymi w notatce technicznej "Using ODBC with Microsoft SQL 
  160. Server" dostΩpnej w pakiecie MSDN. 
  161.  
  162. Plik pomocy Sqlsodbc.hlp do│╣czony do sterownika ODBC SQL 
  163. Server zawiera tylko czΩ£ciow╣ pomoc kontekstow╣ dla kreatora 
  164. ƒr≤d│a danych SQL Server ODBC. Plik pomocy Drvssrvr.hlp 
  165. do│╣czony do poprzednich wersji sterownika ODBC Microsoft SQL 
  166. Server zawiera kluczowe dla sterownika informacje dotycz╣ce 
  167. starszych wersji sterownika. Informacje zawarte w starszych 
  168. wersjach pliku Drvssrvr.hlp s╣ tak┐e zamieszczone w podrΩczniku 
  169. dotycz╣cym serwera SQL Server 6.5 "Programming ODBC for 
  170. Microsoft SQL Server".
  171.  
  172. ****************************************************************
  173. 5. U┐ywanie sterownika w £rodowisku programistycznym
  174.  
  175. Sterownik ODBC Microsoft SQL Server u┐ywa kluczowych dla 
  176. sterownika parametr≤w do kilku wywo│a± funkcji ODBC. Definicje 
  177. #defines dla tych specyficznych dla sterownika parametr≤w 
  178. i struktury programistyczne C i C++ zawarte s╣ w do│╣czonym 
  179. pliku Odbcss.h.
  180.  
  181. Sterownik ODBC SQL Server w wersji 3.7 pracuje z plikiem Odbss.h 
  182. znajduj╣cym siΩ w nastΩpuj╣cych ƒr≤d│ach:
  183.  
  184. * Program SQL Server 7.0
  185.  
  186. * Dodatek SQL Server Service Pack 2 (SP2) lub p≤ƒniejszy dla 
  187. programu SQL Server 6.5
  188.  
  189. * Pakiet MDAC SDK
  190.  
  191. Pakiet MDAC SDK jest czΩ£ci╣ wersji profesjonalnej pakietu 
  192. Microsoft Developer Network. Pakiet SDK mo┐na tak┐e pobraµ 
  193. z witryny sieci Web firmy Microsoft pod adresem 
  194. www.microsoft.com/data. Pakiet SDK jest tak┐e dostΩpny 
  195. w publikacji wydawnictwa Microsoft Press "Microsoft ODBC 3.0 
  196. Software Development Kit and Programmer's Reference".
  197.  
  198. ****************************************************************
  199. 6. Zagadnienia zgodno£ci 
  200.  
  201. Pocz╣wszy od sterownika ODBC w wersji 3.7 dostarczonej 
  202. wraz z programem SQL Server 7.0, u┐ytkownicy programu SQL 
  203. Server 7.0 powinni odwo│ywaµ siΩ do dokumentacji dotycz╣cej ODBC 
  204. w programie SQL Server 7.0. Zagadnienia zgodno£ci udokumentowane 
  205. w tym paragrafie maj╣ zastosowanie tylko wtedy, gdy sterownik 
  206. ten u┐ywany jest z wcze£niejszymi wersjami programu SQL Server 
  207. (4.21a, 6.0 lub 6.5). 
  208.  
  209. Sterownik ODBC SQL Server w wersji 3.7 wy£wietla nowego kreatora 
  210. podczas dodawania lub konfigurowania ƒr≤de│ danych zar≤wno 
  211. w narzΩdziu ODBC Administrator, jak i gdy aplikacja wywo│uje 
  212. polecenie SQLConfigDataSource i prosi sterownik, aby monitowa│ 
  213. u┐ytkownika w celu uzyskania informacji. 
  214. Kliknij przycisk Pomoc w kreatorze, aby uzyskaµ dostΩp 
  215. do dokumentacji kreatora.
  216.  
  217. W sterowniku ODBC SQL Server w wersji 2.65 dostarczanym z
  218. serwerem SQL Server 6.5, parametr SQL_COPT_SS_PERF_QUERY_INTERVAL 
  219. podawany jest w sekundach, a nie w milisekundach, jak opisuje 
  220. dokumentacja (zobacz artyku│ Q157753 w Bazie wiedzy). 
  221. W wersji 3.7 sterownika SQL Server ODBC, parametr 
  222. SQL_COPT_SS_PERF_QUERY_INTERVAL zosta│ zmieniony i podawany jest 
  223. w milisekundach zgodnie z dokumentacj╣.
  224.  
  225. NastΩpuj╣ce zmiany maj╣ wp│yw tylko na aplikacje napisane 
  226. przy u┐yciu interfejsu ODBC 3.X API. Nie maj╣ one wp│ywu 
  227. na aplikacje napisane przy u┐yciu interfejsu ODBC 2.X API. 
  228. Zmiany te nie powinny wp│ywaµ na zestaw wynik≤w w wiΩkszo£ci 
  229. aplikacji ODBC.
  230.  
  231. W poprzednich wersjach sterownika ODBC SQL Server s╣siaduj╣ce 
  232. ze sob╣ instrukcje PRINT lub RAISERROR w plikach wsadowych 
  233. lub procedurach przechowywanych zwraca│y komunikaty razem, 
  234. w jednym zestawie wynik≤w. W sterowniku ODBC SQL Server w wersji 
  235. 3.7 komunikaty dla ka┐dej z instrukcji SQL zwracane s╣ 
  236. w odrΩbnych zestawach wynik≤w. Musisz wywo│aµ funkcjΩ 
  237. SQLMoreResults pomiΩdzy ka┐dym z komunikat≤w, aby ustawiµ 
  238. siΩ na komunikaty nastΩpnej instrukcji SQL. Wszystkie 
  239. komunikaty z pojedynczej instrukcji SQL, takiej jak 
  240. instrukcja DBCC, zwracane s╣ w jednym zestawie wynik≤w 
  241. i nie ma potrzeby wywo│ywania funkcji SQLMoreResults pomiΩdzy
  242. ka┐dym z komunikat≤w.
  243.  
  244. W poprzednich wersjach sterownika ODBC SQL Server b│╣d 
  245. wykonania lub b│╣d RAISERROR z wag╣ b│Ωdu 11 lub wy┐sz╣ 
  246. w pierwszej instrukcji w pliku wsadowym lub procedurze 
  247. przechowywanej zawsze powodowa│, ┐e funkcje SQLExecute, 
  248. SQLExecDirect lub SQLParamData zwraca│y SQL_ERROR. W wersji 
  249. 3.7 sterownika ODBC SQL Server funkcje SQLExecute, SQLExecDirect 
  250. lub SQLParamData zwracaj╣ SQL_ERROR, tylko je£li nie jest 
  251. wykonywana ┐adna instrukcja po pierwszej instrukcji. Je£li 
  252. inna instrukcja wykonywana jest po pierwszej, nawet prosta 
  253. instrukcja RETURN bez warto£ci zwracanej, wtedy funkcje 
  254. SQLExecute lub SQLExecDirect zwracaj╣ komunikat 
  255. SQL_SUCCESS_WITH_INFO. Po przetworzeniu komunikatu 
  256. SQL_SUCCESS_WITH_INFO przy u┐yciu funkcji SQLGetDiagRec, 
  257. trzeba wywo│aµ funkcjΩ SQLMoreResults, aby ustawiµ siΩ 
  258. na nastΩpnym zestawie wynik≤w.
  259.  
  260. Podczas gdy poprzednie wersje sterownika napotyka│y b│╣d 
  261. w pierwszej instrukcji w pliku wsadowym lub procedurze 
  262. przechowywanej, doj£cie do instrukcji by│o dostΩpne dla 
  263. u┐ycia z inn╣ instrukcj╣ SQL, po tym jak funkcja SQLExecute 
  264. lub SQLExecDirect zwr≤ci│a komunikat SQL_ERROR. Gdy 
  265. sterownik w wersji 3.7 zwraca komunikat SQL_SUCCESS_WITH_INFO, 
  266. instrukcja nie jest zwalniana do wykonania nastΩpnej 
  267. instrukcji SQL, dop≤ki funkcja SQLMoreResults nie zwr≤ci 
  268. komunikatu SQL_NO_DATA lub dop≤ki nie zostan╣ zamkniΩte 
  269. wszystkie zestawy wynik≤w nastΩpuj╣ce po instrukcji RAISERROR. 
  270. Je£li po komunikacie o b│Ωdzie nie ma zestaw≤w wynik≤w, 
  271. funkcja SQLCloseCursor nie mo┐e zostaµ wywo│ana; funkcja 
  272. SQLFreeStmt(SQL_CLOSE) lub SQLMoreResults musi zostaµ wywo│ana, 
  273. aby zwolniµ doj£cie do instrukcji w celu wykonania nastΩpnej 
  274. instrukcji SQL:
  275.  
  276. CREATE PROCEDURE TestPrc @Param1 as
  277. IF (@Parm1 IS NULL)
  278. BEGIN
  279.     RAISERROR ('Param1 nie mo┐e mieµ warto£ci NULL', 11, 1)
  280.     RETURN
  281. END
  282. SELECT * FROM sysusers WHERE suid = @Param1
  283. GO
  284.  
  285. Wykonaj nastΩpuj╣ce polecenie:
  286.  
  287. SQLExecDirect(hstmt, "{ call TestPrc (NULL) }", SQL_NTS);
  288.  
  289. Gdy u┐ywana jest starsza wersja sterownika SQL Server ODBC 
  290. lub je£li aplikacja u┐ywa interfejsu ODBC 2.X API, wtedy funkcja 
  291. SQLExecDirect zwraca SQL_ERROR.  Po zwr≤ceniu przez funkcjΩ 
  292. SQLGetDiagRec komunikatu SQL_NO_DATA lub SQL_NO_DATA_FOUND 
  293. przez funkcjΩ SQLError, doj£cie do instrukcji jest zwalniane 
  294. do wykonania innej instrukcji SQL.
  295.  
  296. Gdy u┐ywany jest sterownik ODBC SQL Server w wersji 3.7 
  297. z aplikacji napisanej dla interfejsu ODBC 3.X API, funkcja 
  298. SQLExecDirect zwraca komunikat SQL_SUCCESS_WITH_INFO. 
  299. Po zwr≤ceniu przez funkcjΩ SQLGetDiagRec warto£ci SQL_NO_DATA, 
  300. doj£cie do instrukcji nie mo┐e byµ u┐yte do wykonania innej 
  301. instrukcji SQL, dop≤ki funkcja SQLMoreResults nie zwr≤ci 
  302. informacji SQL_NO_DATA lub nie zostanie wywo│ana funkcja 
  303. SQLFreeStmt(SQL_CLOSE).
  304.  
  305. W poprzednich wersjach sterownika SQL Server ODBC, funkcje 
  306. SQLExecute, SQLExecDirect lub SQLParamData zwracaj╣ 
  307. SQL_SUCCESS, gdy jaka£ aplikacja wykonuje instrukcjΩ 
  308. wyszukuj╣c╣ UPDATE lub DELETE, nie maj╣c╣ wp│ywu na wiersze.  
  309. Z tego wzglΩdu wersja 3.7 sterownika nadal zwraca komunikat 
  310. SQL_SUCCESS do aplikacji napisanych dla interfejsu 
  311. ODBC 2.X API, ale tak┐e zwraca komunikat SQL_NO_DATA 
  312. do aplikacji napisanych dla interfejsu ODBC 3.X API. 
  313. Je£li zar≤wno aplikacja interfejsu ODBC 2.X, kt≤ra otrzyma 
  314. komunikat SQL_SUCCESS, jak i aplikacja interfejsu ODBC 3.X, 
  315. kt≤ra otrzyma komunikat SQL_NO_DATA, nastΩpnie wywo│uje 
  316. funkcjΩ SQLRowCount, funkcja SQLRowCount zwr≤ci warto£µ 
  317. licznika r≤wn╣ zeru.
  318.  
  319. Sterownik ODBC 3.X wyraƒniej definiuje spos≤b zwracania 
  320. wynik≤w ni┐ sterownik ODBC 2.X. Wcze£niejsze wersje 
  321. sterownika SQL Server ODBC zwraca│y warto£ci parametr≤w 
  322. wyj£ciowych i kody powrotu, gdy funkcje sterownika 
  323. ODBC 2.X SQLFetch lub SQLExtendedFetch, zwr≤ci│y komunikat 
  324. SQL_NO_DATA w ostatnim zestawie wynik≤w zwr≤conym przez 
  325. procedurΩ przechowywan╣. Sterownik ODBC dla programu SQL 
  326. Server w wersji 3.7 zachowuje tΩ cechΩ, gdy jest wywo│ywany 
  327. przez aplikacjΩ ODBC 2.X. Gdy wywo│ywany jest sterownik 
  328. ODBC dla programu SQL Server w wersji 3.7 przez 
  329. aplikacje ODBC 3.X, to sterownik nie zwraca parametr≤w 
  330. wyj£ciowych lub kod≤w powrotu, dop≤ki funkcja SQLMoreResults 
  331. nie zwr≤ci komunikatu SQL_NO_DATA.
  332. ****************************************************************
  333.